Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / zc1750d.arc / ZCOMMDOC.AD < prev next >

Wrap

Text File | 1990-01-22 | 79.6 KB | 1,771 lines

Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 91 nlmode Received newlines (linefeed) display as return/linefeed. bell=visual Instead of sounding on the speaker, bell characters cause flashing notes to appear on the screen. overstrike Overstruck characters are displayed in bold face or underline (reverse video on CGA) as appropriate. autowrap The 81st character prints on a new line with possible scrollup. rautowrap Allow a backspace from the lest margin to reverse wrap to the last character position on the previous line. 8bit Decode 8bit control characters and G1 character set. stat=off Disables ZCOMM's status line. warpdrive Provides higher display speed without scrolling flicker, but causes noise (snow/chromablizzard) with CGA display adapters. mapkb Allow escape codes from the remote or a file to active alternate keyboard mapping. The keyboard mapping is defined with a series of mk commands, such as those contained in the std.mk (standard keyboard) or 101.mk (101 key extended keyboard) files. Other XXX.mk files may be provided; the first few lines of these files indicate the keyboard configuration they set up. ZCOMM comes initialized with the std.mk mapping, which requires NumLock to be on. EXAMPLE: source std.mk Defines a VT100 keyboard mapping for standard PC and PC-AT keyboards. The term function keyboard mapping enabled by the mapkb command may override some ZCOMM functions. A display nlmode nobell=visual Turns on nlmode display mode and turns off the visual bell. EXAMPLE: display vt100 Enables VT100/VT102 emulation used by many computer systems. dump pathspec Dump the named files in a side by side hex/ASCII format, similar to the CP/M users' group DUMP program. The ending character number is also displayed. Zero length files are not displayed. echo[c|f] string Echo a line containing a single argument string in reverse video. Tabs should not be used with the echo command. The echoc command also echoes its argument to the capture file (if (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 92 open), without reverse video. The echof command echoes its argument to the capture file only. EXAMPLE: echoc "File not Accepted" Outputs a line to the screen and to the capture file. EXAMPLE: echo "Dave, This conversation can serve no further purpose." Displays a line on the screen only. SEE ALSO: lput command, r numeric parameter, character escapes egrep[m] regular-expression pathspec ** Display lines in the specified files matching regular-expression. Regular Expressions are discussed in Chapter 23. The egrepm command finds a line matching regular-expression in each of the specified files, and then pages through the file beginning with the matched line. At the end of each screen, ZCOMM accepts the same subcommands used with the findm command. EXAMPLE: egrep "^Subject:" *.* Displays all lines that begin with "Subject:". SEE ALSO: findmore command The egrep implementation does not strip the trailing CR/LF from lines read from the disk. This affects use of the $ regular expression magic character. When using the $ magic character, the CR/LF at the end of normal lines must be represented as "..$". egrepq regular-expression pathspec ** Silently searches the specified files for the first line matching regular-expression. Upon a successful search, the contents of this line are stored in the z0 string variable and the ? numeric parameter is incremented. The egrepq command is useful for fetching password information from a disk file. SEE ALSO: obey command, findq command else Execute the command(s) on the rest of the line if the last if test performed on the current script level was false. N.B.: While else statements in programming languages are connected to a particular if statement according to syntax, the connection in ZCOMM is to the last if statement executed on the level, regardless of goto's. ENAble {-modes} Enable mode(s) affecting the term function. Chapter 18 describes modes affecting the term function. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 93 EXAMPLE: ena -h Enables half-duplex (local echo) Half-duplex mode causes the term function to display keyboarded characters. estimate length [speed] Use the specified length and optional specified effective speed when displaying information for the next receive file. A length of 0 bypasses the length substitution. Once a speed (in effective bits per second) is given, it is used for all locally displayed transmission time calculations until the next speed or port command. EXAMPLE: estimate z2 Uses the file length stored in string variable z2 in calculating the transmission time estimate for the next received file. EXAMPLE: speed 19200; estimate 0 2400 Use an effective transmission speed of 2400 for transmission time estimates instead of the 19200 bps interface speed. EXPand sourcefile pathspec ** For each pathname in pathspec, execute the commands in sourcefile with the string parameter item set to the current pathname. The commands in sourcefile must not themselves contain wildcards (* or ?) or directory pathnames. If no files match pathspec, sourcefile is not executed. If the script executed has a READ ONLY attribute, ZCOMM is unrestricted during execution of the script. EXAMPLE: expand plxupl 001* Executes the script plxupl once for each file matching the wild card specification 001*. EXAMPLE: expand a *.arc where the file a contains: obey "!pkxarc -v %item >> arclist" lists the contents of all .arc files to arclist. Chapter 99 explains the use of this command in more detail. f [-modes] file The f (think of "file") command initiates transmission of file with the term function. One or more term function modes (described in Chapter 18) may be enabled with the optional modes flag. If q (TWX) mode is enabled, transmission pauses until the called system's answerback restarts it with an XON, or until g mode is set. Otherwise, any XOFF induced transmission pause is reset. Once the file has been opened with the f command, a pattern match or keyboarding F1 or ALT-X will exit the term function with file (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 94 incompletely transmitted. The rest of the file may be transmitted by the t, F2, or wait commands. EXAMPLE: f -px message Uploads message paced by the p mode, which sends a carriage return and pauses at the end of each transmitted line until the remote responds with the prompt character (default line feed). The x mode makes the term function return to the script after the file has been transmitted. EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p file Is useful for uploading a prepared message to a CompuServe bulletin boards using the "SIG" editor (not FILGE). The eolstr setting sends a carriage return and period after each line to prevent the CompuServe software from reformatting the message. Pp10000 Sets the pause timeout to a long time. Pg58 Sets the prompt character to ":". f -p file Transmits the file. SEE ALSO: b, g, p, r, n, t, w, x, X modes, eolstr string parameter, t and wait commands fail Terminate the current expand command, otherwise return from the current script level with failure status. If called directly by another level of script, that level is terminated. The fail command also causes the term function to exit, to allow a function key to be programmed with a macro that exits the term function. If called implicitly by a number presented for dialing, fail terminates the current dialing attempt. If no retries are left, the call is abandoned. fg Indicates ZCOMM is running in the foreground with a user at the keyboard. SEE ALSO: bg command, df test condition fget outfile * Gets 8 bit raw data from the modem to outfile without any protocol. No data is displayed on the screen. Keyboarding F1 terminates recording; any other keyboarded character is sent to the remote. Iff the g numeric parameter is set to to some value other than its default of 10 (line feed), the fget command terminates upon reading and storing a character matching the g numeric parameter. The fget command also terminates recording on loss of carrier detect signal. This command can be used when the flow of data from the remote (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 95 cannot be regulated. The maximum rate attainable without loss of data is limited by the maximum interrupt latency of the operating system and active device drivers. The time required to write a 512 character buffer to disk may also limit the maximum average data rate. Each 512 character block must be written before the modem interrupt input buffer overflows with new data. If the startup time for a floppy disk is excessive, better results will be obtained writing to a hard disk or ramdisk[9] if a suitable device is available. Tests with an IBM Personal Computer, DOS 2.1, and a Maynard Electronics hard disk suggest that no characters are lost at 9600 baud. (Your results will vary depending on your configuration and programming habits. California estimates lower.) EXAMPLE: fget rawdata find string pathspec Find and display lines containing matches to string in the specified files. Lower case characters in string match either case; upper case characters in string match upper case characters only. If string contains spaces, tabs, or semicolon, it must be enclosed by double quote characters. ZCOMM C style escapes may be used to represent control characters and string parameters to be searched for. Assuming normal DOS files (with CR/LF at the end of each line), a \n at the beginning of string forces a match to the beginning of a line. A \r at the end of string (\n if the file(s) have no returns in them) forces a match at the end of the line. The file name being searched and its length are displayed in the status line. For each line that contains a match to string, the file name (if more than one file), line number, and the text of the line are displayed. EXAMPLE: find count *.c Finds all occurrences of count or COUNT in the named files. SEE ALSO: egrep command FINDMore string pathspec Findmore finds a line matching string in each of the specified files, and then pages through the file beginning with the matched line. Otherwise, it is similar to the find command. When the screen is filled up, the prompt More? appears. Typing space displays another screenfull. Typing n skips to the next instance of string that has not yet been displayed. Typing ^Q or ^S displays one more character from the file. Typing ^X skips to __________ 9. See comments on Extended Memory ramdisks in Chapter 26. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 96 the next file. SEE ALSO: egrepm, page commands findq string pathspec Silently searches the specified files for the first line matching string. The processing of string is identical to the find command described above. Upon a successful search, the contents of this line are stored in the z0 string variable and the ? numeric parameter is incremented. The findq command is useful for fetching password information from a disk file. SEE ALSO: egrepq command finish Terminates Kermit server operation on the remote system. fput file * Puts data from file to the remote at maximum speed without any protocol. After each 512 characters, the number of characters transmitted is displayed in the status line, and the keyboard is polled. Any key will abort the transfer. This is the fastest way ZCOMM can transmit characters to the modem, with possible peak speeds greater than 19kb. This command is useful for testing RS232 peripherals at high peak rates such as 56 kilobaud. EXAMPLE: fput datafile fpute file * Echoplex transmit a file to the remote, waiting for the correct echo to each character transmitted (for Throttle/10 seconds). The echoed character is sent to the CRT screen. If fpute receives a space as an echo to a tab, fpute waits for the spaces to stop echoing for at least 100 milliseconds before resuming transmission. Transfer speed thus suffers when tabs are present in the transmitted file unless the remote can be set to echo tabs as tab characters instead of expanding them to spaces. Throughput is less than 1/3 of normal because of the echo delay. Fpute counts each time the correct character is not echoed as an error. With n mode, fpute transmits only a linefeed at the end of each line. With r mode, fpute transmits only a carriage return at the end of each line. Most applications would use one of these modes. CPMEOF (Ctrl-Z) terminates the file transmission unless b mode is set. Because fpute waits for the correct echo to each character sent, fpute should be used for transmitting characters to programs that echo exactly. Often it is easy to write a simple receive routine to synchronize (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 97 with the sender by echoing each character received. On some microcomputer systems, the device "TTY:" does just that. Fpute is especially useful for "spoon feeding" files to the serial inputs of microcomputers and minicomputers. SEE ALSO: f command get filespec Instructs a remote Kermit server to the transmit the specified file(s), then receives them. The form of filespec varies with the remote system; it must be quoted if it contains any special characters or spaces. The get command only operates with a Kermit server; use kermit rb to receive files from a regular Kermit program. goback label Search the current script file for label: and execute commands starting at that line. The goback command begins the search at the beginning of the file. It is faster than the goto command which begins the search at the current line. SEE ALSO: goto command gosub name[.path] Call a script as a subroutine. The phone directory is searched for name unless another file is specified with .path. Gosub has the same action as the call command (q.v.), but does not reset modes, disconnect the modem, or modify the remote parameter. EXAMPLE: gosub dosig Executes the dosig entry in the telephone directory. EXAMPLE: gosub .%lib/baud.t Executes the commands in c:/yam/baud.t assuming the lib string parameter contains c:/yam. SEE ALSO: call command goto label Search the current script file for label: and execute commands starting at that line. A label begins at the first column and ends with a colon (:). Iff label precedes the current script line, the goback command will locate the target label more quickly. The goto command is valid only within a script or telephone directory entry. Please refer to Chapter 99 for examples using the pattern, if, goto, and source commands. grab svar Grab reads a line from the currently open transmit file into the specified string parameter svar. Unless b mode is on, all characters starting with the first CR and/or LF are discarded. Grab inhibits transmission of the open file until g mode is explicitly set by a command. On end of file the transmit file is closed and the string parameter (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 98 is set empty. End of file can be tested with the t test condition. SEE ALSO: putv command HAndshake {off|sw|on|cts|dsr|dcd|both|slow} Some modems and printers cannot accept continuous full speed data. These devices send control characters (XOFF and XON) for flow control, or generate a hardware flow control signal on the CTS, DSR, or DCD pin. The Handshake command controls the modem port hardware handshake (default sw).[10] If hardware handshaking is selected, an ON to OFF transition on the specified line pauses transmission, and an XON character will not override the hardware restraint. After a timeout set by the S numeric parameter (default 60 seconds), or if characters are in the keyboard input buffer, a warning message is displayed, the restraint is released, and characters are sent. As a special case, handshake on obeys output flow control with the CTS input signal, asserts input flow control with the RTS output signal, and disables the transmission of XOFF characters when the modem input buffer becomes nearly full. Some computers do not support concurrent disk and serial I/O at high speeds. The handshake slow command drops the RTS signal to the modem during disk writes when receiving files with YMODEM-g or ZMODEM. The command handshake both allows either CTS or XOFF to pause output, in addition to asserting input flow control with the RTS output. The handshake dcd command enables d mode (q.v.). Subsequently, selecting a different type of handshaking will disable d mode. The "handshake off" command disables all flow control except for the term function. The handshake command releases flow control (allows data to flow if it had been stopped by handshaking). __________ 10. ZCOMM automatically disables its software (XON/XOFF) flow control when using XMODEM, YMODEM and similar protocols that require all 256 byte codes. These protocols will not work if the modem is set for software flow control. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 99 Changing the communications port with the port or portx command disables hardware handshaking. SEE ALSO: S numeric parameter EXAMPLE: handshake cts Turns on CTS handshaking. help The help command uses the helpfile or xhelpfile string parameter depending on whether ZCOMM is in host operation. Normally, the help command displays a command summary, pausing every 24 lines. If the string parameter begins with the character @, ZCOMM uses the rest of the parameter as the initial command to access a pop-up help program. The contents of the f string parameter are added to this command, separated by a space. Thus, if helpfile contains "@yhp /umanh.hlp", giving the help command from the main prompt executes the DOS command "yhp /umanh.hlp main". If the called program leaves a file yamhelp.tmp containing script commands in the current directory, ZCOMM executes this file with a source command and then deletes it. SEE ALSO: f, helpfile, xhelpfile string parameters, source command history [histfile] Opens histfile for use as a dual 64 entry history file for commands entered both at the ZCOMM command prompt and online with the term function. Histfile is a random access file used as a pair of circular buffers to save commands for recall. Only a file created by a previous history command may be used with the history command. If the specified histfile does not exist, it is created. Histfile stores commands with T or more characters where T is the value of the T numeric parameter. If histfile is not specified with the history command, the current history file is updated and closed. The history command may be given with a different file name whenever desired to access useful commands saved from previous sessions with a particular host or application. When history is enabled, the Up and Down function keys scroll through previously entered commands. Ctrl-P and Ctrl-N may be used in place of Up and Down respectively. An old command so selected may be edited with editing keys and executed with the <ENTER> key. In the term function, the history accessed with the Up and Down keys is displayed and edited in the status line. [11] A Ctrl-X clears the (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 100 recalled text and restores normal status line and keyboard operation. EXAMPLE: history /tmp/favbbs.hist SEE ALSO: r command, T numeric parameter N.B.: Do not give the history command before you have entered any secret passwords from the keyboard as these will be saved in the history file. The history command without an argument closes the history file and disables command recall. Alternatively, the T numeric parameter may be set to a large value to inhibit storing of passwords in histfile. Normally, histfile should be an absolute pathname to insure that the same file will be used regardless of the directory from which ZCOMM is called from. The history command is not available when Restricted. N.B.: Do not attempt to delete an open file on DOS, especially the history file. host The host command conditions ZCOMM to accept incoming calls unattended. Host operation is described in Chapter 99. The EXIT key F1 terminates Host Operation. N.B.: The host command is normally given only by a script that sets parameters to their appropriate values. Use the "host" entry in the distributed PHODIR.t file as a prototype for your application. SEE ALSO: remote command if condition command ... The if command provides powerful condition testing for scripts. If executes the command(s) on the rest of the line if condition is true. Otherwise, execution continues immediately with the next script line. Chapter 24 describes the testable conditions. SEE ALSO: else, on commands ife condition cmd1 ...; cmd2 ... Execute cmd1 ... if condition is true; otherwise skip to the first semicolon in the rest of the line and resume execution (unconditionally) with cmd2. Iff a semicolon is not present, execution resumes at the end of the line, useful within the body of a while command. ______________________________________________________________________ 11. Unix/Xenix flavors only support Backspace editing in this mode. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 101 EXAMPLE: set f5 @ife %s1 echo "s1 =%s1"; else echo "s1 not set" (Without the "else", the right half will always execute.) kbdlock N * Controls acceptance of keyboarded characters by the term function and during protocol file transfers. If N is non zero, the term function does not act upon key strokes. If N is greater than 1, key strokes have no effect on protocol transfers. The Ctrl-Break key and the command prompt reset kbdlock to 0. If N is 257, the Ctrl-Break key does not reset Kbdlock. Kbdlock does not affect the k test condition or the accept command. Characters typed while kbdlock is on will become available at the next command prompt, accept command, or when kbdlock is reset unless typeahead is purged with the purgek command. SEE ALSO: purgek command, Ctrl-Break key kbdmon [file] captures keystrokes to file. If file exists, it is appended to. Function keys are denoted by an 0xFF character followed by the code returned by the BIOS. The kbdmon command without an argument closes the file. This command is not available when Restricted. kermit By itself, selects Kermit or Kermit related parameters for use by the !!, p, rb, and sb commands. Kermit rb [-options] Kermit rb receives files using the Kermit file transfer protocol. Chapter 17 describes the available options. File names are given by the sending program. The Kermit programs must have compatible parity settings as described in Chapter 11, Kermit Protocol. Kermit rb receives files from a regular Kermit program; use the get command to receive files from a Kermit server. EXAMPLE: kermit pi1; kermit rb Downloads files from an IBM mainframe. ZCOMM's term function will sense the remote Kermit's parity setting and download files without user intervention When the remote Kermit starts sending, if K (Kermit autodownload) mode is enabled (the default). Kermit sb [-options] pathspec Kermit sb sends the specified files to either a regular Kermit program or a Kermit server. Chapter 17 describes the available options. The Kermit programs must have compatible parity settings as described in Chapter 11, Kermit Protocol. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 102 EXAMPLE: kermit pi1; kermit sb file ... Sends the specified files to an IBM mainframe. keys, ALT-K Keys displays the definitions the user has assigned to the function keys. ki Clears the y0...y127 string parameters and causes circular buffer writing operations to ignore data from the remote which has already been displayed. This data is still available to the review function. EXAMPLE: The script fragment pat 1c "///BEGIN///" "@ki create -+ print.fil" pat 2c "///END///" "@close" wait -f30000 will capture the data that arrives between "///BEGIN///" and the end of the string "///END///". Other data from the remote will not be captured to disk. The long pattern match fail time (30000 seconds) makes the the cycle repeat almost indefinitely. SEE ALSO: W mode kill Erases (flushes) all data stored in the circular buffer and restores the buffer pointers to their initial positions. kill [-signum] procnum Available on Unix and OS/2 flavors, this form of the kill command supports interprocess communications. If signum is absent, the kill command checks for the existence of the specified process, but does not send it a signal. Success sets the ? numeric parameter to 0, otherwise -1. SEE ALSO: createx command, Unix kill(1) l, ll, ls, lx For Unix users, synonyms for the dir commands. learn lfile TurboLearn(TM) Script Writer records timing information and term function keystrokes to lfile. The TurboLearn program tlearn.exe then generates a script using this data. Normally, learning is initiated after the connection has been established, but before the first prompt is received from the remote. This is best accomplished with the F4 key, which activates the tlearn telephone directory entry. Function keys, cursor keys, reassigned keys, and scripts[12] should (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 103 not be used while learning. When accepting passwords and other sensitive information, systems sometimes acknowledge each keyboard character with #, *, x, or X, instead of the keyboarded character itself. When this happens, do not type characters faster than the remote responds to them. The resulting script should be examined for evidence of keyboarding mistakes, line noise, and dependence on prompts that change each time you access the system. The comments below apply when the tlearn script is not used. EXAMPLE: kill 123-4567; learn lfile From the ZCOMM main command prompt, enter the desired phone number. When ZCOMM connects, the learn command enters the term function with learning (recording) turned on. <keyboard the operations you wish recorded> Login to the bulletin board as usual. If you make keyboarding mistakes, you can edit the script file later. ALT-C F1 Terminate learning with ALT-C, and return to the main command prompt with the F1 key. !tlearn lfile >newscript From the main command prompt, execute the TurboLearn program tlearn with a DOS Gateway. After recording, the tlearn program reads lfile and generates a series of pattern and put script commands to let ZCOMM search for the prompts and respond with the proper keystrokes. The resulting script file newscript may be accessed with the source command. Alternatively, the last command above may be replaced with !tlearn -d newdirname lfile >>phones.t ______________________________________________________________________ 12. Other than the dialing script (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 104 to add the new script to the end of your telephone directory. The -d dirname causes tlearn to prepend the given new directory entry name newdirname and the telephone number to the resulting script commands. The redirection characters >> add the script commands to the end of your telephone directory. You can also use the -d newdirname option to tlearn to prepare a new directory entry in a separate file. Then you can edit this file and add it somewhere within your telephone directory. link * Link two serial ports. The link command allows remote access to a computer or other device connected to another port. For example, if port 1 is connected to an autoanswer modem and port 2 is connected to a local timesharing machine, the link command would allow dial-up callers access to the timesharing machine. Chapter 15.5 describes the link command. list pathspec The list command uses standard DOS character output routines and any installed CRT device driver instead of ZCOMM's own CRT driver. The printer can be enabled with ^P given to DOS (not ZCOMM). List the specified file(s). This command closes any open transmit file. ZCOMM detects SQueezed files and prints them in ASCII.* List pauses/resumes printing with ^S. Keyboarding ^C cancels, and ^X skips to the next file (it might take a few whacks of the keyboard to get ZCOMM to hear it.) The list command defaults to a type command when ZCOMM is in host operation. EXAMPLE: list *.cq SEE ALSO: browse, type, page commands lput string Displays string on the console display. String is processed for character escapes. Lput is useful for scripts sending cursor control codes to the screen. Control characters and escape sequences used with the lput command are always decoded with ZCOMM's default extended VT52/Z19 emulation, which also recognizes ANSI "ESC [" sequences, regardless of which display emulation is selected. Unlike the echo command, lput does not display in reverse video and does not add a carriage return/linefeed to its argument. SEE ALSO: echo command lputp string Outputs string to the line printer. String is processed for character escapes. Strings with embedded nulls (represented with the \000 character escape) may be used. The lput command should not be used if the printer is jammed, out of paper, or off line. These conditions may be tested with the l test condition. This command is not allowed when ZCOMM is Restricted. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 105 EXAMPLE: if l lputp "\E\017" If the printer is ready, ZCOMM sends ESC SI to select compressed printing on an IBM 80 CPS printer. SEE ALSO: l numeric parameter, l test condition, \dNNN (decimal) character escapes menu Execute script commands from the file name stored in the string parameter menu. message The message command allows a caller to keyboard a message which will be appended to a file specified by the string parameter messages. The message command allows the caller to type in up to 64 lines of text. A blank line terminates the message. This command is intended for short messages; long messages should be uploaded with a file transfer protocol. Keyboarding is controlled by the Z numeric parameter, which sets the hot zone column after which a keyboarded space character begins a new line. mk [scancode shiftstate class string] Assign term function keyboard mapping. Without an argument, mk resets and disables keyboard mapping. The mk command is described in Chapter 24. SEE ALSO: N numeric parameter, _ command more pathspec See page command. mput string The mput command transmits string to the remote at full speed. String is processed for character escapes. Unlike the put and putw commands, mput does not display characters coming from the remote (they are held in the interrupt buffer). Control and other special characters may be entered with character escapes. If a carriage return should be sent, it must be explicitly coded with \r at the end of the string. SEE ALSO: put, putw commands nolog * Suppress generation of the next log entry (of any kind). EXAMPLE: mysys nolog speed 1200 123-4567 t Suppresses the log entry that would otherwise be made if the calllog string parameter is set. nulls n When accessing ZCOMM in host operation, nulls sets the number of nulls (default 0) sent after each linefeed to allow slow terminals time to scroll. EXAMPLE: nulls 4 (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 106 o Terminates a data call by dropping DTR (Data Terminal Ready). DOS ZCOMM drops Clear To Send (CTS) as well as DTR if hardware flow control was selected with the handshake command. A bye or speed n command must be given to reassert DTR before making or answering another data call.[13] The o command does not release ownership of the serial port. SEE ALSO: speed, bye, off, port commands obey string Sometimes one wishes to execute the contents of a string parameter as a ZCOMM command. Other times one needs to reference a pathname stored in a string parameter in the context of a command that does not itself perform string substitution on its argument(s). Obey executes string as a ZCOMM command. Character escapes in string are substituted before execution. EXAMPLE: obey ">>%s0" Redirects the output of utility commands to the pathname stored in string parameter s0. EXAMPLE: pat 19c "OBEY-LAST" "@obey %y2" Sets pattern 19 to execute the previous line received from the remote when the string "OBEY- LAST" is received. N.B.: The remainder of the line after the obey command will be executed unless execution of string is terminated by a return or fail command. The construction obey "if xxx goto foo" May be used only if no commands follow the obey command's string argument. N.B.: Backslashes in file names used with the obey command must be escaped. N.B.: When the obey command is used to substitute file names, file names containing separator or operator characters such as & may change the syntax of the resulting command. For instance, the pathological but legal DOS filename foo&&999.bar would cause obey if f%thisfile gosub dofile to expand to if ffoo&&999.bar gosub dofile to parse as a test for a match to an illegal pattern 999. off Disable the modem by dropping DTR (Data Terminal Ready), [14] release ownership of the serial port, and exit to the operating system. DOS ZCOMM drops Clear To Send (CTS) as well as DTR if hardware flow control was selected with the handshake command. __________ 13. Most telephone directory entries include a speed command. 14. The modem must be configured to use Data Terminal Ready (DTR). (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 107 Exit status is the value of the ? numeric parameter. The next program must select the port and initialize it to reassert DTR before making or answering another data call. SEE ALSO: bye, x, o, port commands on [condition rest-of-line] * Executes rest-of-line if condition is true. Condition is tested after each command line executes, unless a return or fail command is executed, or when pattern is the last command on the line. An on command without predicate (on a line by itself) cancels the on command active at that script level. EXAMPLE: on The term function may be accessed with the wait command and no patterns active to force an exit on loss of carrier detect or pattern search timeout. Otherwise, ZCOMM could remain in term function until a command is keyboarded. Typical commands to use with the on statement are goto, return, off, and abort. Chapter 24 describes the testable conditions. One active on statement is available for each level of script. The on statement does not propagate to succeeding script levels. When rest-of-line is executed, the on statement at that level is cancelled. An on command cancels any previous on command at that script level. EXAMPLE: on !c goto fooend Branches to fooend if the carrier drops out. SEE ALSO: wait, if commands NB: No other commands may be on the line after the on command except for its predicate. open [-modes] file Opens file for transmission with the term function with modes. The open command should be used when you don't want to enter the term function immediately, or are already in it. In other situations, it may be necessary to open the file before dialing to allow transmission immediately after connection, without the delay of opening the file from a floppy disk. SEE ALSO: seek, read, close commands page pathspec Type the file(s) specified in pathspec a screenfull at a time. When the screen is filled up, the More? prompt appears. Typing space displays another screenfull. Typing ^X skips to the next file. Typing ^K or ^C terminates the command. This command closes any open transmit file. ZCOMM automatically detects SQueezed files and prints them in ASCII.* (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 108 EXAMPLE: page *.doc SEE ALSO: browse, type, list, findmore commands PATtern [n[cilpv$] string [action]] (n = 0...24) The pattern command allows ZCOMM to search for up to 25 different responses from a remote computer, and take action based on which of those responses (or none) was "seen". A pattern match can execute specified script command(s) "on the fly" (c modifier) or return control to the calling script with an indication of which pattern was matched. The pattern command causes the next t, f, or wait command (term function) to search for string in the data received from the remote/modem. String must be entered exactly as it will be received from the modem, in the same case and with the same embedded spaces or tabs. Control characters must be represented with ZCOMM character escapes. The metacharacter \256 matches any single character. ZCOMM %string substitutions may be used to define search patterns. If the % character is to be searched for, it must be represented as \045. Parity, NULL, RUBOUT, XON, and XOFF characters received from the remote do not affect pattern searches. If Kermit AutoDownload (K mode) is set, strings with SOH (Ctrl-A) cannot be matched. If ZMODEM AutoDownload (Z mode) is set, strings with CAN (Ctrl-Z) cannot be matched. If B protocol (c mode) is set, strings with DLE or ENQ cannot be matched. Strings of up to 33 characters each may be specified for simultaneous search by the term function. The search patterns are "global" among all script levels; a pattern command in a subroutine affects the patterns set by the calling script(s) and vice versa. The term function returns when one of the patterns is matched or when the term function times out with f seconds with no characters from the remote, as determined by the f numeric parameter, or when carrier detect is lost. The first wait, t or f command given after the pattern command begins the search. When one of the patterns is matched, that pattern is marked as found and its corresponding action is executed (if present). ZCOMM will remain in the term function until there is a pause in data transmission from the remote[15] unless the i or c modifier is used. __________ 15. Pause length is specified by the q numeric parameter. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 109 The following modifiers may be used. The c, i, and l modifiers are mutually exclusive. c The pattern is marked as found and action executed (if present). The term function then continues searching. Matching this pattern does not cause a return from the term function. The condition for this pattern will test true, but the n test condition is not affected. i (Immediate) The pattern is marked as found and action executed (if present). The term function then returns immediately. l (line end delay) The pattern is marked as found and action executed (if present). The term function then returns after the first LF character following the matched string. p (permanent) A pattern with the p modifier is not reset by the pattern command without arguments. Patterns with the p modifier may be used to search for disconnect messages within an entire script. Permanent patterns are reset by the call command, each item in the outcall queue, and an explicit pattern command referencing that particular pattern number. EXAMPLE: pattern 20 "\nCLR" "@off" Disconnects and exits ZCOMM if the phrase CLR is seen immediately following an LF. v (verbose) The v modifier displays a message when the pattern is matched. This is often useful when debugging scripts when the large amount of output generated by large v numeric parameter values is not desired. EXAMPLE: pat 5v "Finished Already." $ Sometimes the only way to recognize a prompt (as distinct from the same string embedded in other data) is to require the prompt to be the last thing sent by the remote, before a pause. The $ modifier allows string to be matched only if the remote pauses for 1 to 2 seconds after transmitting the last character in string. The optional action is a string to be sent to the remote, or executed as a command if it begins with "@". Action is executed the instant the last character of the pattern is matched, even if the i modifier is not used. Action must not use the goto, f, t, or wait commands. The pattern command without any arguments clears the patterns that don't have the p modifier, and terminates pattern searching. The other events that terminate pattern search are a match to a pattern (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 110 that does not have the c modifier, a pattern search timeout, the call, abort, or quit commands, a major error, or the NUKE key. EXAMPLE: pat 0c$ "" "\21" Sends one XON character every time there is a pause in output from the remote. This recovers from situations where the remote computer stops because it receiveed a spurious XOFF character, or lost an XON character. In the pattern n string command, if string contains a repeating sequence such as foo in foofoobar, the search may be unsuccessful if part of the phrase is received immediately prior to the desired string (foofoofoobar). port n Change the modem port to COMn. On DOS, the legal values for n are 1...18. Selecting a new port normally selects software handshaking ("handshake sw"). The PCDOS flavor enables both hardware and software handshaking ("handshake both") iff the port speed exceeds 2400 bps and the Clear To Send (CTS) signal is active at the time the port command is given. Standard Ports (PCDOS)_: COM1 3F8 IRQ4 (Standard IBM) COM2 2F8 IRQ3 (Standard IBM) NON STANDARD PORTS: COM3 3E8 IRQ4 (Alternate) COM4 2E8 IRQ3 (Alternate) COM5 2B8 IRQ3 (Columbia) COM6 2B8 IRQ2 (Alternate for IBM) COM7 3E8 IRQ5 (Alternate "COM3") COM8 2E8 IRQ5 (Alternate "COM4") COM9 Uses the port address and interrupt vector previously set by the portx command. COM11-COM18 IBM PS/2 COM1-COM8 ports COM1 and COM2 are the standard serial ports defined by the IBM Technical Reference Manual. COM3 and COM4 are supported by many serial cards and modem boards. COM3 and COM1 share the same dedicated hardware interrupt line, and these ports may not be used at the same time. Likewise, COM4 and COM2 may not be used at the same time. Columbia computers support COM5. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 111 COM6 to COM8 are alternate configurations that may be accessed by cross jumpering between printer port decoders and serial port enables on some multifunction boards. COM7 and COM8 support alternative definitions for "COM3" and "COM4" respectively. COM11 to COM18 correspond to "COM1" to "COM8" on IBM PS/2 computers. Only one of COM12-COM18 may be used at a time unless using the special OS/2 comm driver for that board. Since ZCOMM uses the interrupt line on the selected port, no other program or device driver may use the same port address and/or interrupt vector concurrently. Certain disk controllers and mice interfaces use IRQ2 and IRQ5. Do not use IRQ2 on a PC-AT (the extra 8259 is not reset). IRQ5 is sometimes used by network cards and printer ports. Do not select COM3 to COM18 unless you are familiar with the I/O addresses and interrupt vectors used in your machine. Ports sharing the same interrupt vector (IRQ number) cannot be used concurrently. The port command sets the d mode (which suppress the No Carrier Detect message). EXAMPLE: port 2 DOS ZCOMM begins with COM1 unless overidden by the DPORT environment variable. EXAMPLE: C>set DPORT=2 On Unix, the argument of the port command is a character special file in the /dev directory. Unix and Xenix flavors have no default port. If the DPORT environment variable is set, that port will be selected when ZCOMM initializes. Otherwise, a port is selected by the startup and/or dialing script. Typical values are tty01 (386/ix) and tty2A (Xenix). EXAMPLE: DPORT=tty1A; export DPORT SEE ALSO: handshake command, dport string parameter portx hbase,irq * To support specialized multiport serial interfaces, the portx command selects a communications port with a specified hexadecimal base address hbase and Interrupt Request Line irq (3 <= irq <= 7). The portx does not check its argument for validity. The consequences of an invalid selection are quite undefined. The specified base address and IRQ number are assigned to COM9, where (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 112 they may be used by the port command and the x numeric parameter. The status line and s command will indicate COM9. This command not available on X.PC, Unix, Xenix, or OS/2. EXAMPLE: portx 3f8,4 Selects a comm port with a base address of 3f8, using IRQ4. SEE ALSO: intolink string parameter private The private command allows a caller to keyboard a message which will be appended to a file specified by the private string parameter. The private command allows the caller to type in up to 64 lines of text. A blank line terminates the message. This command is intended for short messages; long messages should be uploaded with a file transfer protocol. Keyboarding is controlled by the Z numeric parameter, which sets the hot zone column after which a keyboarded space character begins a new line. purgek Purge any characters the user may have typed ahead.* purgel Purge any unprocessed characters received from the modem Line (remote).* put string The put command transmits string to the remote. Use the put command for transmittting commands to a modem or a remote computer system. String is processed for character escapes. Control and other special characters may be entered with character escapes described in Chapter 23. If a carriage return should be sent, it must be explicitly coded with \r at the end of the string. EXAMPLE: put "myname\r" Sends myname followed by carriage return to the modem. A \336 (octal 336) character causes a pause in transmission (duration controlled by the p numeric parameter). This pause allows one string to contain multiple commands. EXAMPLE: put "\336ATZ\r\336\336ATX1 M0 S0=1\r" Pauses, sends ATZ\r, pauses (twice because some modems take longer to reset!), and then sends ATX1 etc. to the modem. Transmission with put is controlled by the 7, 8, h, p, w, and t modes. SEE ALSO: putw, mput, putv commands putw string The putw command transmits string to the remote, and pauses for a period of time (determined by the q numeric parameter) (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 113 before returning from the term function to allow characters to echo. Other than that final pause, putw operates the same as the put command. N.B.: Putw should not be used when the next operation will be a pattern or wait command. If the expected response starts before the putw command finishes, the following wait command will never get to "see" what it is waiting for. In general, the putw command should only be used as a short-cut for sending a command when the response is known in advance and can be safely ignored. SEE ALSO: put, mput commands putv svar The putv command transmits svar to the remote without any translation of character escapes. Putv does not append a carriage return or line feed to the transmitted string. EXAMPLE: putv s0; put "\r" SEE ALSO: put, mput commands pwd Print Working Directory displays the current directory pathname, and stores it in the pwd string parameter. EXAMPLE: pwd SEE ALSO: cd command pxN Set Numeric parameter x to value N. If x and N are blank, display the numeric parameters which can be set by this command and their current values. This command is not allowed if Restricted. Numeric parameters are described in Chapter 21. EXAMPLE: ps8 Sets the status line attribute to 8 (grey), suitable for composite video displays. EXAMPLE: pv-1 Sets the v numeric parameter ("verbose") to -1, suppressing some routine messages. More negative values suppress more routine messages. EXAMPLE: pd1 Sets the d numeric parameter to 1, causing files received with ZMODEM or full YMODEM protocol to be stored with the modification date transmitted with the file. EXAMPLE: pk3 Sets the k numeric parameter to 3, which kills pending output stored in the circulat buffer when ETX (Ctrl-C) (decimal 3) is keyboarded in the term function. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 114 queue { add [string] | clear | delete [n] | list | run } Manipulate and execute a queue of commands for dialing numbers or other suitable functions. The queue contains 20 slots numbered 0 to 19. queue clear clears all queue entries. queue add [string] adds string to the queue after processing for string substitutions. The string is added to the first empty queue slot available. If string is absent, it is taken from the next script line. A typical string would be a command to call a system: call telegodzilla Script entries used with the circular dialing queue should end with a t command, which will enter the term function. To stop the queue at that point, use the ALT-N (NUKE) key. NUKE queue delete [n] Delete then nth queue entry, or the currently executing entry if n is not present. queue list lists the non empty queue entries. queue run begins execution of the queue entries. The ALT-N (NUKE) key, a fatal errror or any keyboarded character present after the execution of the command in the entry terminates the queue run command. The queue commands are independant of the Outcall Queue available in Host Operation. EXAMPLE: The script fragment: queue clear while q set? s0 Q queue add "echo %s0" queue list Sets each queue entry to echo its own queue number, then lists the queue entries. SEE ALSO: q and Q test conditions, Shift-F5 and Shift-F6 function keys quit * Causes an immediate return to the command prompt from any script level. Quit may be used within a command string assigned to a function key where an unconditional return to the command prompt is desired, even if keyboarded from the term function. r [oldcmd] Search back through the history file of keyboarded lines for the first line that oldcmd is a prefix of, and execute it. If oldcmd is absent, execute the last locall entered keyboarded line. EXAMPLE: history C:/tmp/junk.hst del *.bak *.lst *.tmp *.foo (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 115 cd bazdir r d del *.bak *.lst *.tmp *.foo (command echoes) SEE ALSO: history command r7 [-options] [dir] [file ...] Receives with options 1 or more files using MODEM7 batch protocol. An optional directory dir may be specified. If pathname(s) have been supplied to the r7 command and the sending program attempts to send more files than the number of names supplied to the r7 command, the transfer is aborted. The command is provided for compatibility with traditional programs that do not support the superior YMODEM or ZMODEM protocols. EXAMPLE: r7 -c Receive file(s) with MODEM7 Batch and CRC-16 (-c). SEE ALSO: MODEM7 batch protocol, Chapter 11. rb [-options] Receives with options 1 or more files using YMODEM batch protocol. The rb command also receives files sent with SEAlink protocol. Chapter 17 describes the available options. The pathname and length of each file are transmitted in batch mode. If a file is received in error (retries exhausted, etc.), the batch transfer will terminate. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: rb -y Receive file(s) with YMODEM replacing old files, if any. EXAMPLE: rb -g Receive file(s) with YMODEM-g. Many programs claiming to support YMODEM actually use XMODEM with 1024 byte blocks; use ZCOMM's sx -k, rx and rx -g XMODEM commands with these mutants. SEE ALSO: YMODEM protocol, Chapter 11. rb [-options] [dir] [file ...] Receives with options 1 or more files using YMODEM batch protocol. An optional disk and/or directory dir may be specified. The optional supplied pathnames file ... are used in place of pathnames normally provided by the sending program. If the sending program attempts to send more files than the number of names supplied to the rb command, the transfer is aborted. rc [-options] file Receives with options a single file using the Ward Christensen XMODEM protocol, 128 or 1024 byte blocks, and CRC-16 instead of an 8 bit checksum. ZCOMM signals the sending program that CRC-16 is to be used. After four errors while attempting to (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 116 receive the first sector, ZCOMM will cancel the CRC-16 option and reverts to checksum operation. The probability of an undetected transmission error is much less if CRC-16 is used in place of the default 8 bit arithmetic checksum. Omen Technology Inc Recommends use of the 16 bit CRC to maintain data integrity at professional levels. Chapter 17 describes the available options to the rc command. If Restricted, a file received in error will be deleted. EXAMPLE: rc foo.com SEE ALSO: XMODEM-CRC protocol, Chapter 11. read [file] Read file into the circular buffer. Once in the buffer, it may be examined with the review command, searched for strings, and cut and pasted to other files. If file does not fit into the buffer, the buffer may be cleared with the kill command (or review k subcommand) and subsequent read commands may be given to read more of it. Review function commands are described in Chapter 20. EXAMPLE: read allsig.tmp<ENTER><Home> SEE ALSO: BROwse, seek commands CAUTION: Iff a read command has left a transmit file open, entering the term function will transmit the unread portion of the file. To prevent this, close the file first with ALT-C or closetx. receive Receives file(s) from a Kermit program. The other program must be commanded to send the desired files. SEE ALSO: get Kermit server access command remote Enter Host state with unrestricted privileges to allow the currently connected remote computer/terminal to issue commands. When activated by the remote command, Host state will reset when the modem carrier goes away. This command is useful for transferring files between two machines with directly connected serial ports. Remote may be prefixed with restrict to limit privileges.* SEE ALSO: host command remote cwd dirspec [password] Instructs the remote Kermit server to change to the specified directory. The form of dirspec varies with the remote system; it must be quoted if it contains special characters or spaces. A password may be required by the remote Kermit server. SEE ALSO: Kermit Protocol, Chapter 11. (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 117 remote delete filespec Instructs the remote Kermit server to delete the specified file(s). The form of filespec varies with the remote system; it must be quoted if it contains special characters or spaces. remote dir dirspec Instructs the remote Kermit server to display the specified directory on your screen. The form of dirspec varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. remote help Instructs the remote Kermit server to display help information on your screen. The resulting information may be redirected to a file with the >outfile command. remote host host-command-string Instructs the remote Kermit server to perform the specified command and display its output on your screen. The form of host-command-string varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. EXAMPLE: remote host "kill -9 0" Terminates all your processes with extreme prejudice. SEE ALSO: !!command remote print filespec Instructs the remote Kermit server to print the specified file(s) on the remote system. The form of filespec varies with the remote system; it must be quoted if it contains special characters or spaces. remote space [dirspec] Instructs the remote Kermit server to display the free space in the specified directory on your screen. The form of dirspec varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. remote type filespec Instructs the remote Kermit server to type the specified file(s) on your screen. The form of filespec varies with the remote system; it must be quoted if it contains special characters or spaces. The resulting information may be redirected to a file with the >outfile command. remote who Instructs the remote Kermit server to display the logged in users on your screen. The resulting information may be redirected to a file with the >outfile command. reset Write the contents of the circular buffer if a receive file is open, close all files, and reset the disk system. This allows (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 118 swapping diskettes. reskeys Resets the Soft Keys to empty. SEE ALSO: set command restime * Resets elapsed time and counts of bytes transmitted and received to zero. The restime command may be given in a script immediately after login is completed to synchronize the elapsed time counter with the beginning of chargeable connect time. SEE ALSO: timestamp command, E test condition restrict * Restricts ZCOMM for the following command on the same line. This command is useful for testing. EXAMPLE: restrict source /menu.t RETurn Returns from a script subroutine accessed by a call, source, or gosub command. SEE ALSO: fail command rewind Reset the buffer pointers for display, printer, and file output used by the term function to the beginning of the circular buffer. This will cause the term function to redisplay the data in the circular buffer. Patterns will be rescanned. A typical use of the rewind function is to allow replay of an editing session on a remote machine, or to redisplay the material received if the initial settings of the i, c, n or v modes were incorrect for the material received from the remote. N.B.: The rewind command does not reset the buffer free character count. To write the data to disk, a write command (or ALT-W) must be given before accepting new data from the remote. SEE ALSO: t, b, w review subcommands REView Review the data received from the host or read by the read command. A screenfull is displayed at a time. Review function commands are listed in Chapter 20. ro [-options] file Receives with options a single file using non- standard XMODEM-CRC protocol logic. OverThruster(TM) speeds file downloads at the expense of error recovery. OverThruster operation is controlled by the O numeric parameter. As fans of Buckaroo Bonzai know, the OverThruster is not universally applicable. A transmission error will almost always terminate an OverThruster file download. If Restricted, a file received in error will be unlinked (erased). (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 119 EXAMPLE: ro foo.com SEE ALSO: O numeric parameter rt [-options] [dir] [file ...] Receives with options 1 or more files using Telink (FIDO) batch protocol. An optional disk and/or directory dir may be specified. The optional supplied pathnames file ... are used in place of pathnames normally provided by the sending program. If pathname(s) have been supplied to the rt command and the sending program attempts to send more files than the number of names supplied to the rt command, the transfer is aborted. The rt command is provided for compatibility with traditional programs that do not support the superior YMODEM or ZMODEM protocols. EXAMPLE: rt -c SEE ALSO: Telink protocol, Chapter 11. rw [-options] file Receives with options a single file using the People-Link WXMODEM protocol. Chapter 17 describes the available options. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: rw foo.com rx [-options] file Receives with options a single file using the Ward Christensen XMODEM protocol. CRC-16 is not the default because most commercial comms programs only support the 8 bit checksum. Chapter 17 describes the available options. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: rx foo.com N.B.: The rc command should be used whenever possible instead of rx. EXAMPLE: rx -g foo.txt Receive a single file with an ACKless XMODEM protocol mutant incorrectly called "ymodem-g" by PCBoard and Qmodem programs. SEE ALSO: XMODEM protocol, Chapter 11. rz [-options] Receives with options 1 or more files using ZMODEM batch protocol. Chapter 17 describes the available options. Each file's pathname is obtained from the sending program. The +, a, b, n, N, r, and y options are accepted from the sending program, subject to Restriced privileges. If the +, b, n, N, r, or y option is (C) 1989 Omen Tech Inc Chapter 17 Main Commands Version 17.50 TurboDial 2.33 Universal Line Printer Edition ZCOMM User Manual 120 specified to the receiver, it overrides any contrary options specified to the sender. Only one of the a, b, or r options may be specified. Only one of the +, n, N, or y options may be specified. If a file is received in error (retries exhausted, etc.), the batch transfer will terminate. If Restricted, a file received in error will be unlinked (erased). EXAMPLE: rz -y SEE ALSO: Z mode SEE ALSO: ZMODEM protocol, Chapter 11. rz [-options] [dir] [file ...] Receives with options 1 or more files using ZMODEM batch protocol. An optional disk and/or directory dir may be specified. The optional supplied pathnames file ... are used in place of pathnames normally provided by the sending program. If the sending program attempts to send more files than the number of names supplied to the rz command, the transfer is aborted. To allow use of the rz command, Z mode (ZMODEM autodownload) should be turned off with a dis -Z command. s Displays status information. LSR and MSR refer to the Line Status Register and Modem Status Register of the modem port's 8250 UART device. TYP refers to the type of serial chip detected. A National 16550A shows as 1, an Intel 82510 shows as 2. Other chips (without high speed enhancements) show as 0. "Uncorrected errors" displays the e numeric parameter, which counts the number of failed file transfers and "line hits" detected by the term function. If one or more scripts are active, the current line number (counting from the first line in the script file) for each script level is displayed. Any patterns active as a result of a pattern or wait command are displayed. An S indicates not matched (still searching), F indicates that pattern has been matched. SEE ALSO: ALT-S function key s7 [-options] pathspec Send the files specified in pathspec using the MODEM7 batch Protocol. Files which cannot be opened are skipped. An empty pathspec sends all files in the current directory. A directory name expands to all regular files in that directory. (C) 1989 Omen Tech Inc Chapter 17 Main Commands